home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 16 / anarkey2.zip / UPDATE.DOC < prev   
Text File  |  1989-05-01  |  13KB  |  297 lines
  1.  
  2.  
  3.  
  4.                         ANARKEY 2.00 Update Information
  5.                         -------------------------------
  6.  
  7.  
  8.  
  9.    Welcome to ANARKEY Version 2.00.
  10.  
  11.    Version 2.00 is a major update.  Many new features and enhancements have
  12. been added to the previous version.  In addition, several standalone support
  13. programs are provided which greatly increase the flexibility of ANARKEY's
  14. operation.  Altogether, ANARKEY 2.00 provides one of the most powerful,
  15. compact and flexible command-line environments available on a DOS machine.
  16.  
  17.    This update sheet briefly explains the new 2.00 features.  It is provided
  18. so current users of version 1.00 can upgrade quickly and smoothly.  New
  19. ANARKEY users should read the "ANARKEY User Manual" and related support-
  20. program manuals before diving in head-first.
  21.  
  22.  
  23.  
  24.                             Distribution Policy
  25.                             -------------------
  26.  
  27.    ANARKEY is distributed as full-time shareware.  This means each user is
  28. given the opportunity to evaluate the complete ANARKEY software package with
  29. no obligation.  If, after trying ANARKEY, you find it to be a useful tool,
  30. you must register your copy with the author, Steven Calwas.
  31.  
  32.    If you purchased a disk containing ANARKEY from any place other than
  33. directly from the author, you have NOT registered your copy.  The only way
  34. to register ANARKEY is by sending your registration form directly to the
  35. author, Steven Calwas.  The appropriate address is listed on the
  36. registration form and elsewhere in the ANARKEY documentation.
  37.  
  38.    ANARKEY registration is only $25 which includes a copy of the next
  39. version when it becomes available.  Considering the large number of times
  40. you will be using ANARKEY during each computer session, this is an
  41. outstanding value.  If you use ANARKEY, please honor the shareware pact by
  42. making this minimal payment.
  43.  
  44.    An ANARKEY registration form is included with the distribution package in
  45. the file ORDERFRM.  Please take the time to fill it out and return it.  If
  46. you would like high-quality software to continue to be made available on a
  47. try-first basis and for a reasonable cost, it is up to YOU to support such
  48. programs.  Please do.
  49.  
  50.    Supporters of version 1.00 are automatically given "Registered-User"
  51. status.  Registered users may receive a copy of future updates at a nominal
  52. cost (currently $6).  Updates for registered users may be obtained by
  53. filling out the order form (ORDERFRM) included in the ANARKEY distribution
  54. package.
  55.  
  56.  
  57.  
  58.                                   AKAs
  59.                                   ----
  60.  
  61.    ANARKEY now supports a text-substitution feature referred to as an AKA
  62. (pronounced A-K-A).  A similar capability is available in other command-
  63. line editors and is often referred to as an alias or synonym.  AKA is an
  64. acronym for "AnarKey Alias" or "Also Known As" (take your pick).
  65.  
  66.    An ANARKEY AKA may be a straight text substitution operation or it may
  67. contain parameter arguments specified using the DOS batch-file convention of
  68. %1 through %9.  Of course, an AKA may contain multiple commands.
  69.  
  70.    An AKA may be defined on the DOS command line or read from a disk file by
  71. LOAD, the ANARKEY Loader (discussed below).
  72.  
  73.    Support for AKAs is optional.  If you do not reserve storage space for
  74. your AKA definitions at ANARKEY installation time, none of the AKA-handling
  75. code will remain resident.  Thus, people who do not use AKAs achieve a
  76. memory savings.
  77.  
  78.    AKAs are a major new feature with too many details to explain adequately
  79. here.  Please read the "AKA Functions" section in the "ANARKEY User Manual"
  80. for a complete explanation.
  81.  
  82.  
  83.  
  84.                     ANARKED -- The Anarkey Keystroke Editor
  85.                     ---------------------------------------
  86.  
  87.    ANARKED is a standalone support program that allows you to reassign the
  88. keystrokes associated with ANARKEY functions.  With ANARKED, you can
  89. configure ANARKEY to the keystroke conventions of your word processor,
  90. previous command-line editor or your own personal preferences.
  91.  
  92.    ANARKED is extremely easy to use and does not require a cryptic
  93. configuration file or baroque installation procedure.  It is also capable of
  94. generating a summary list of all ANARKEY functions and their corresponding
  95. keystroke invocations.  This summary sheet may then be listed to a printer
  96. or viewed onscreen as a handy reference guide.
  97.  
  98.    Since ANARKED is a non-trivial program, please read the "ANARKED User
  99. Manual" (in the disk file ANARKED.DOC) for further details.
  100.  
  101.  
  102.  
  103.                           LOAD -- The Anarkey Loader
  104.                           --------------------------
  105.  
  106.    LOAD is another of the new ANARKEY support programs.  LOAD will read
  107. ASCII text files into the ANARKEY history buffer at any time.  In version
  108. 1.00, loading the history buffer was only possible at installation time.
  109. Thus, LOAD provides a new level of flexibility to the history buffer's
  110. contents.
  111.  
  112.    LOAD will also read and process AKA definitions stored in a disk file.
  113.  
  114.    Refer to the "LOAD User Manual" (LOAD.DOC) for a complete explanation of
  115. this useful tool.
  116.  
  117.  
  118.  
  119.                   CONVERT -- The Anarkey AKA Conversion Utility
  120.                   ---------------------------------------------
  121.  
  122.    Many people already use a DOS command-line editor and have accumulated a
  123. list of aliases or synonyms which that editor recognizes.  In most cases,
  124. the format used to define an alias or synonym is specific to each editor and
  125. is not compatible with other editors.  This incompatibility is not a problem
  126. with ANARKEY.
  127.  
  128.    CONVERT is a conversion utility that will accept alias and synonym
  129. definitions for other command-line editors and translate them into the
  130. ANARKEY format.  CONVERT relieves the user of tiresome editing work and
  131. eases the transition from an old command-line editor to ANARKEY.
  132.  
  133.    CONVERT documentation can be found in the "CONVERT User Manual"
  134. (CONVERT.DOC).
  135.  
  136.  
  137.  
  138.                           Operational Enhancements
  139.                           ------------------------
  140.  
  141.    Version 2.00 also includes some useful enhancements to v1.00 operations.
  142.  
  143.    -- When completing the name of a directory, program or file, the cursor
  144.    is positioned at the end of the completed name.  Previously, the cursor
  145.    position remained unchanged.
  146.  
  147.    -- When retrieving an environment variable, an equal sign may be included
  148.    at the end of the variable name.  Thus, both of these lines are valid
  149.    when retrieving environment variables (the underscore represents the
  150.    cursor position):
  151.  
  152.                                   >path_
  153.                                   >path=_
  154.  
  155.    -- The PROMPT environment variable is handled in the same manner as the
  156.    PATH variable.  In other words, it does not require "SET" to preceed it
  157.    on the command line before retrieving its current value.  Also like SET
  158.    and PATH, additional commands may not follow a PROMPT command on the
  159.    input line.
  160.  
  161.    -- There are a couple of history buffer line-retrieval and storage
  162.    enhancements.
  163.  
  164.         -- If a line is retrieved from the history buffer and accepted
  165.         without editing the line or moving the cursor, the line is MOVED
  166.         from its current position to the buffer's end.  This movement saves
  167.         buffer storage space by eliminating duplicate lines and guarantees
  168.         that often-executed lines are always available for retrieval.
  169.  
  170.         This line movement may be repressed by specifying the -F (Full
  171.         Disclosure) option on the ANARKEY installation command line.
  172.  
  173.         -- When a line is accepted, the position of the CBL (current buffer
  174.         line) pointer is saved.  This saved-CBL pointer is IN ADDITION TO
  175.         the v1.00 CBL pointer.  As in v1.00, the CBL is always set to the
  176.         end of the history buffer when beginning a new input line.  Thus, at
  177.         the start of each command line, there exist two pointers into the
  178.         history buffer: the CBL (pointing at the buffer's end) and the
  179.         saved-CBL (which points at the CBL's old position when the last
  180.         command line was accepted).
  181.  
  182.         In v2.00, the CBL may be restored to the saved-CBL position by
  183.         pressing the <PgDn> key.  This operation provides for the quick
  184.         retrieval of consecutive lines in the buffer.
  185.  
  186.         For a more detailed discussion of this feature, refer to the section
  187.         "Retrieving a Group of Commands" in the "ANARKEY User Manual."
  188.  
  189.    -- A new ANARKEY function has been added.
  190.  
  191.    <Alt-F3>           -- Retrieve Remainder of Previous Line and Execute
  192.         This function is the same as the Retrieve-Remainder-of-Previous-
  193.         Line-and-Edit function (<F3>) except that the line is immediately
  194.         sent to the command processor for execution.  The user is given no
  195.         opportunity to edit the line.
  196.  
  197.         Of course, this keystroke invocation, like all other ANARKEY
  198.         keystrokes, may be changed by ANARKED.
  199.  
  200.    -- Due to restrictions which occur when displaying characters on a serial
  201.    terminal, ANARKEY automatically disables itself whenever output is
  202.    redirected to a serial terminal (i.e. the COM device).  Output can be
  203.    redirected to a COM device by executing the CTTY command or by specifying
  204.    the output-redirection character (>) on the command line.
  205.  
  206.    With ANARKEY disabled, input is handled by the original DOS buffered-
  207.    input routine.  When output is reset to the console, ANARKEY will
  208.    automatically enable itself.
  209.  
  210.    -- ANARKEY will temporarily disable itself when processing a multiple-
  211.    command line and the currently-executing program shells to a secondary
  212.    command processor.  ANARKEY will enable itself when the secondary shell
  213.    and executing program have both terminated.  This situation is explained
  214.    in detail in the "ANARKEY User Manual" section "Entering Multiple
  215.    Commands per Line: Multiple-Command Lines and Secondary Shells."
  216.  
  217.  
  218.  
  219.                            Installation Options
  220.                            --------------------
  221.  
  222.    The ANARKEY installation options have been reorganized for version 2.00.
  223. Many new options are provided and most of the v1.00 options have been
  224. changed or become obsolete.
  225.  
  226.    THE NEW OPTION SPECIFICATIONS ARE INCOMPATIBLE WITH THE V1.00 OPTIONS!
  227.  
  228.    If you are currently installing ANARKEY v1.00 with options, please refer
  229. to the "Installation Options" section of the "ANARKEY User Manual" before
  230. installing version 2.00.
  231.  
  232.    Among the new options are the capabilities to:
  233.  
  234.         -- display ANARKEY resident memory usage
  235.         -- run ANARKEY in quiet mode (fewer annoying bells)
  236.         -- specify the length of the shortest line to be stored in the
  237.            history buffer
  238.         -- use the switchar conventions of the UNIX operating system (this
  239.            is NOT implemented by calling the undocumented DOS function,
  240.            thus, it will work in the OS/2 DOS 3.x compatibility box)
  241.  
  242.    Since there are so many changes in the option area, users are directed to
  243. read the "Installation Options" section of the "ANARKEY User Manual."
  244.  
  245.  
  246.  
  247.                              Summary of Summary
  248.                              ------------------
  249.  
  250.    As mentioned in this update sheet, many of the new ANARKEY features are
  251. too complex to summarize here.  To fully understand these new powers,
  252. version 1.00 users should read the following sections of the "ANARKEY User
  253. Manual":
  254.  
  255.         -- History Buffer Functions: Retrieving a Group of Commands
  256.         -- AKA Functions
  257.         -- Entering Multiple Commands per Line: Multiple-Command Lines and
  258.                 Secondary Shells
  259.         -- Installation Options
  260.  
  261.    In addition, each of the manuals for the three support programs should be
  262. read.
  263.  
  264.         -- ANARKED.DOC, the ANARKED User Manual
  265.         -- LOAD.DOC,    the LOAD User Manual
  266.         -- CONVERT.DOC, the CONVERT User Manual
  267.  
  268.  
  269.    After reviewing ANARKEY 2.00, I hope you'll find it to be a powerful
  270. program that deserves to be part of your computer environment.  If so,
  271. please take the time to register the program.  Doing so will guarantee that
  272. further updates will be forthcoming and that you will receive them.
  273.  
  274.    Also, I am extremely interested in hearing your comments and suggestions
  275. concerning all aspects of ANARKEY.  Please tell me of any new features or
  276. enhancements you would like to see in future releases.  As always, all
  277. comments will be given serious consideration.  I would love to hear from
  278. you.
  279.  
  280.    Please fill out the registration form and send it with your comments and
  281. suggestions to:
  282.  
  283.                                 Steven Calwas
  284.                                Moderne Software
  285.                                 P.O. Box 3638
  286.                           Santa Clara, CA 95055-3638
  287.  
  288.                               _______
  289.                          ____|__     |               (tm)
  290.                       --|       |    |-------------------
  291.                         |   ____|__  |  Association of
  292.                         |  |       |_|  Shareware
  293.                         |__|   o   |    Professionals
  294.                       -----|   |   |---------------------
  295.                            |___|___|    MEMBER
  296.  
  297.